home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / g_man / cat3 / OpenGL / glxcopycontext.z / glxcopycontext
Encoding:
Text File  |  1998-10-20  |  7.1 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ggggllllXXXXCCCCooooppppyyyyCCCCoooonnnntttteeeexxxxtttt((((3333GGGG))))          OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee ---- GGGGLLLLXXXX          ggggllllXXXXCCCCooooppppyyyyCCCCoooonnnntttteeeexxxxtttt((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ggggllllXXXXCCCCooooppppyyyyCCCCoooonnnntttteeeexxxxtttt - copy state from one rendering context to another
  10.  
  11.  
  12. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      void ggggllllXXXXCCCCooooppppyyyyCCCCoooonnnntttteeeexxxxtttt( Display *_d_p_y,
  14.                           GLXContext _s_r_c,
  15.                           GLXContext _d_s_t,
  16.                           GLuint _m_a_s_k )
  17.  
  18.  
  19. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  20.      _d_p_y   Specifies the connection to the X server.
  21.  
  22.  
  23.      _s_r_c   Specifies the source context.
  24.  
  25.  
  26.      _d_s_t   Specifies the destination context.
  27.  
  28.  
  29.      _m_a_s_k  Specifies which portions of _s_r_c state are to be copied to _d_s_t.
  30.  
  31.  
  32. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  33.      ggggllllXXXXCCCCooooppppyyyyCCCCoooonnnntttteeeexxxxtttt copies selected groups of state variables from _s_r_c to _d_s_t.
  34.      _m_a_s_k indicates which groups of state variables are to be copied.  _m_a_s_k
  35.      contains the bitwise OR of the same symbolic names that are passed to the
  36.      OpenGL command ggggllllPPPPuuuusssshhhhAAAAttttttttrrrriiiibbbb.  The single symbolic constant
  37.      GGGGLLLL____AAAALLLLLLLL____AAAATTTTTTTTRRRRIIIIBBBB____BBBBIIIITTTTSSSS can be used to copy the maximum possible portion of
  38.      rendering state.
  39.  
  40.      The copy can be done only if the renderers named by _s_r_c and _d_s_t share an
  41.      address space.  Two rendering contexts share an address space if both are
  42.      nondirect using the same server, or if both are direct and owned by a
  43.      single process.  Note that in the nondirect case it is not necessary for
  44.      the calling threads to share an address space, only for their related
  45.      rendering contexts to share an address space.
  46.  
  47.      Not all values for OpenGL state can be copied.  For example, pixel pack
  48.      and unpack state, render mode state, and select and feedback state are
  49.      not copied.  The state that can be copied is exactly the state that is
  50.      manipulated by OpenGL command  ggggllllPPPPuuuusssshhhhAAAAttttttttrrrriiiibbbb.
  51.  
  52.      An implicit ggggllllXXXXFFFFlllluuuusssshhhh is done by ggggllllXXXXCCCCooooppppyyyyCCCCoooonnnntttteeeexxxxtttt if _s_r_c is the current
  53.      context for the calling thread.
  54.  
  55.  
  56. NNNNOOOOTTTTEEEESSSS
  57.      Two rendering contexts share an address space if both are nondirect using
  58.      the same server, or if both are direct and owned by a single process.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ggggllllXXXXCCCCooooppppyyyyCCCCoooonnnntttteeeexxxxtttt((((3333GGGG))))          OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee ---- GGGGLLLLXXXX          ggggllllXXXXCCCCooooppppyyyyCCCCoooonnnntttteeeexxxxtttt((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      A _p_r_o_c_e_s_s is a single execution environment, implemented in a single
  75.      address space, consisting of one or more threads.
  76.  
  77.      A _t_h_r_e_a_d is one of a set of subprocesses that share a single address
  78.      space, but maintain separate program counters, stack spaces, and other
  79.      related global data.  A _t_h_r_e_a_d that is the only member of its subprocess
  80.      group is equivalent to a _p_r_o_c_e_s_s.
  81.  
  82.  
  83. EEEERRRRRRRROOOORRRRSSSS
  84.      BBBBaaaaddddMMMMaaaattttcccchhhh is generated if rendering contexts _s_r_c and _d_s_t do not share an
  85.      address space or were not created with respect to the same screen.
  86.  
  87.      BBBBaaaaddddAAAAcccccccceeeessssssss is generated if _d_s_t is current to any thread (including the
  88.      calling thread) at the time ggggllllXXXXCCCCooooppppyyyyCCCCoooonnnntttteeeexxxxtttt is called.
  89.  
  90.      GGGGLLLLXXXXBBBBaaaaddddCCCCuuuurrrrrrrreeeennnnttttWWWWiiiinnnnddddoooowwww is generated if _s_r_c is the current context and the
  91.      current drawable is a window that is no longer valid.
  92.  
  93.      GGGGLLLLXXXXBBBBaaaaddddCCCCoooonnnntttteeeexxxxtttt is generated if either _s_r_c or _d_s_t is not a valid GLX
  94.      context.
  95.  
  96.      BBBBaaaaddddVVVVaaaalllluuuueeee is generated if undefined _m_a_s_k bits are specified.
  97.  
  98.  
  99.  
  100. MMMMAAAACCCCHHHHIIIINNNNEEEE DDDDEEEEPPPPEEEENNNNDDDDEEEENNNNCCCCIIIIEEEESSSS
  101.      On all SGI systems, _s_r_c must be the current context and, except in the
  102.      case of direct rendering contexts on IIIInnnnffffiiiinnnniiiitttteeeeRRRReeeeaaaalllliiiittttyyyy, RRRReeeeaaaalllliiiittttyyyyEEEEnnnnggggiiiinnnneeee,
  103.      RRRReeeeaaaalllliiiittttyyyyEEEEnnnnggggiiiinnnneeee2222, and VVVVTTTTXXXX systems, _d_s_t must have been made current to some
  104.      thread prior to the copy.
  105.  
  106.      On RRRReeeeaaaalllliiiittttyyyyEEEEnnnnggggiiiinnnneeee, RRRReeeeaaaalllliiiittttyyyyEEEEnnnnggggiiiinnnneeee2222, and VVVVTTTTXXXX, on IIIInnnnffffiiiinnnniiiitttteeeeRRRReeeeaaaalllliiiittttyyyy, on HHHHiiiigggghhhh
  107.      IIIImmmmppppaaaacccctttt and MMMMaaaaxxxxiiiimmmmuuuummmm IIIImmmmppppaaaacccctttt, on SSSSoooolllliiiidddd IIIImmmmppppaaaacccctttt systems, and on OOOO2222 systems, it
  108.      is not possible to use a context for rendering to both windows and
  109.      pixmaps.
  110.  
  111.  
  112. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  113.      ggggllllPPPPuuuusssshhhhAAAAttttttttrrrriiiibbbb, ggggllllXXXXCCCCrrrreeeeaaaatttteeeeCCCCoooonnnntttteeeexxxxtttt, ggggllllXXXXIIIIssssDDDDiiiirrrreeeecccctttt
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.